FileFind 0.05 (05-Apr-1992)
===========================

 Jon Ribbens, 1992


This program is PUBLIC DOMAIN. This means that you can copy it around as much
as you like as long as you don't make any money out of it and you include all
the files.



This is the second time that's happened. Just the other week I wrote a virus
killer, and the day after I managed to contract a virus, which was then
killed by my virus killer. Next I wrote a file finding utility, and the day
after that I needed to locate a file wot I had lost....


Anyway, if you've ever lost a file, on hard disc or on floppy, then this is
the utility for you. (The main use on floppies is searching for a certain
file through a lot of discs.) The user interface is based on VProtect, so if
you can use that you can use this straight off.


Installing FileFind
-------------------

FileFind uses my WimpExtension module, which handles things like 3D icons,
pointer changes, linked windows, iconbar sprites, templates loading,
indirected icon handling, colours menus, window handling, icon dragging,
caret positioning, dialogue boxes, etc. It expects the file 'WimpExt' to be
in your !System.Modules directory, so if you don't already have
WimpExtension 1.15 or later then move the file 'WimpExt' from inside the
!FileFind directory to inside your !System.Modules directory.


Setting up
----------

Click on the iconbar icon to open the setup window. The window is divided
into two main sections with some buttons underneath.

The 'Start directory' section is used to specify what directory to start
searching in. You can type the pathname (eg. 'scsi::HardDisc.$') in the
writeable icon, you can drag the icon to a directory viewer, or you can drag
a file or directory from a directory viewer to the 'Start directory' area.

The 'Search pattern' section is used to specify what you are searching for.
You can specify a filename (using the normal RISC OS wildcards * and #), and
you can specify a type. You can enter any normal filetype (eg. 'Text',
'Obey', 'FFB', etc.) or the special cases 'Any', 'File', 'Directory' or
'Untyped'. Both these writeable icons have arrow icons next to them leading
to menus containing common options.

The 'Save' button saves the current choices in the application directory so
they will be the same next time you load FileFind. 'Cancel' will close the
window and ignore any changes you have made. 'OK' will close the window and
remember the changes. 'Search' will remember the changes, close the window
and start searching.


Searching
---------

When it starts its search, FileFind will open the status window to show what
it's doing. The 'Directory' field shows what directory it is currently
searching. The 'Matches' field shows how many files/directories have been
found matching the description given so far. The filename being searched for
is shown on the right. The 'Cancel' button cancels the search (but you can
still look at the files found so far). The 'Pause' button pauses the search.
The button will change to 'Continue', and the search will be resumed when you
click on this.

The filenames found will be stored and shown in the list window. If you find
very many files then FileFind will grab more memory to store the names. The
slot starts at 16k and will increase to accomodate the extra names.


List window
-----------

The list window will appear if any matches are found. The files are listed in
the order they were found, with their filetype and full pathname shown. You
can scroll up and down through the list as normal. If you double-click on a
name then a directory viewer will be opened showing that file (or into that
directory if it was a directory). During searching, the if the list window is
scrolled to the bottom then it will continue moving down as more files are
found. If you close the window during a search, it can be re-opened by
clicking on the number of matches field in the status window. If you close it
when the search has finished then the names will be forgotten, and memory
released if more was grabbed to accomodate the names.



Adverts
-------

Buy Lifeguard, the all new extremely good screensaver for the Arc. Runs in
the desktop, has pretty effects - these are supplied as effects files which
can be added into the library, you can write your own effects and include
these if you like. Written in 100% ARM code, it takes only 16k + effects. A
module screenblanker is included for out-of-desktop blanking or for if the
desktop crashes.

Get !VProtect, my virus killer, it looks remarkably similar to FileFind
actually, there's consistency for you. At present kills Module and Extend,
is hugely faster than Acorn's Killer, takes only 48k, has auto-scan whereby
files and applications are scanned quickly when you double-click on them.

Look out for lots of other stuff, Hourglass, RoughTime, EliteCheat, Mover,
etc. New stuff coming out sometime includes WimpHelp, Domination, Minefield.

If you write programs in the desktop, then you'll probably think that
WimpExtension is incredibly good. It will hopefully be released soon for
general use, just as soon as Acorn find me some SWI numbers...

***NEWS FLASH*** New version of Lifeguard coming soon, utterly improved (as
                 if there could be any improvement on the original) with
                 even better effects (cor)....



Any complaints, money, demos, PD, explosive devices, etc. to

                Jon Ribbens
                39 Nutkins Way
                Chesham
                Bucks.
                HP5 2BE

Uploaded to the Newcastle Info-server by Jon Thackray (jrmt@ukc.ac.uk, Jak@Arcade BBS).

N.B. Please note that this is not quite the final release version, but the only thing that isn't
     quite implemented is the saving of the list of files found, which is only partly implemented.
